JAM v1.0 The AGENDA view that PSION forgot! Introduction Despite many excellent features, the AGENDA application is a cumbersome tool to use if you need to quickly identify when you have free time. This problem is usually apparent when you have a busy agenda and you need to arrange an appointment. Using AGENDA you will either view each day individually or use the weekly view and scroll through each day. Either method is relatively slow and requires a lot of keyboard activity. I have written JAM to overcome these problems. JAM displays TIMED entries only and utilises a scrollable 24hr*56 day window with black boxes indicating the time you have already allocated. This graphical display is easy to interpret and you will be able to see at a glance what time is allocated and what remains free. Although you may initially perceive JAM as being a slow application (in the absence of a SDK I've used OPL), you will hopefully soon discover that JAM is faster than using AGENDA when arranging appointments. To maximixe speed I have included a SNAPSHOT facility which will instantaneously display the JAM window as it appeared when you last launched JAM. This facility allows you to process the AGENDA file, quit JAM then display the JAM window later without the need for reprocessing. After much debate I have decided to release JAM as a kind of "Guiltware". JAM is composed of 2 modules. If you want the second module you will need to mail me and ask for it. The theory is that if you like JAM enough to ask for the second module then you will hopefully like it enough to pay the registration fee! This is my second effort at Shareware for the PSION. It's required several weeks work and I would ask that you seriously consider registering, if only to encourage me to continue developing applications for your PSION 3a. The money would also be nice! Whatever you decide, I hope that you find JAM an invaluable tool which will make your use of the PSION 3a even more pleasurable than it already is! Installation Copy JAM.OPA to your \APP\ directory and install in the usual way by pressing< PSION>< I>. Getting Started Launch JAM by selecting one of the AGENDA files listed below the JAM Icon and press ENTER. Startup options Use SnapShot This option may appear when you start JAM. This will rapidly load the JAM window with Timed entries as they appeared when JAM was last run. Please be aware that this will not show entries created after the snapshot and that if the Agenda file has been tidied or compressed the Text of the entries will not display correctly. This is because the Snapshot file contains a pointer to the text, NOT the actual text itself (which is in the AGENDA file). This approach keeps the size of the snapshot file to a minimum. The snapshot files are JAM.TMP and JAM1.TMP in the \OPD\ directory. No harm is done if you wish to delete them, new ones will be created by JAM. Include Repeats Repeat processing is relatively slow so if you can remember your repeat entries you have the option of disregarding the repeats. You may find some speed benefits by changing repeats with a very old start date to start closer to today. To do this you will need to change the end date of the repeat to before today and add a new repeat starting fom today. This will not effect daily or weekly repeats but will effect monthly by date, monthly by days and annual repeats. Display Text whilst Processing This will display the text of each entry as JAM reads the AGENDA file. This will slow processing slightly. How many Days in Window The JAM window is scrollable so you can use anything between 1 and 56 days. Larger windows require more memory and will take longer to process. Use Procedure Cache With this turned on JAM will allocate a dynamically variable cache to optimize speed. JAM will use as much memory as is needed up to the maximum available. If the Procedure Cache is off JAM will use less memory but will be slower. Menus File Quit Exits the Application Date New Start Date Reprocess the file using a new start date. Default start date is today. Process Next Window Reprocess the file starting from the day after the end of the current window. Options Exclude Repeats Valid during processing only. Cancels the processing of any further repeats. Add Timed Entry Valid after processing. Allows you to write a timed entry to the AGENDA File. Alarm can be included although you may ony use RINGS,CHIMES or SILENT sounds. This is only available in the second module, JAM1.OPO. About Displays Registration information and Help. Function Keys displays the Menus. Note that the Menus are different during and after processing. Arrows Moves the cursor 1 day or 1 hour. Arrows Moves the cursor 12 hours or 7 days. whilst the cursor is on an enty will display the text of the entry. Memos are not displayed. <+> <+> will display all entries after the cursor position. will cancel the entry details display. will display the Shareware message and details of the Function Keys. Sharing JAM with the AGENDA The AGENDA file must not be open by AGENDA when the file is processed by JAM,when adding entries, or when you wish to display the text of an entry. You CAN open the AGENDA file from the AGENDA application after JAM has finished processing. Version History V1 (Jan 95) Original version. V1a (9th Feb 95) Minor bug fixes and additional functionality. 1. Tone now sounds at the end of processing of the AGENDA File. 2. JAM looked for the additional JAM.OPO module in the \APP\ directory of the disk on which the AGENDA file resided. JAM now looks for this module in M:\APP\ A:\APP\ and B:\APP\ 3. The Use Snapshot option now correctly warns if Repeat processing was turned off during the previous session. Have Fun! Martin Sturgess TK26 PO BOX 45 TONBRIDGE KENT TN9 1AL UNITED KINGDOM